home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / pock41.zip / GENERAL.DOC < prev    next >
Text File  |  1994-06-01  |  11KB  |  257 lines
  1.                *************************
  2.                * General Documentation *
  3.                *************************
  4.  
  5.                PocketD Plus v4.1 (D.EXE)
  6.  
  7.       Directory Listing, Copy and File Management Program
  8.     PocketD (TM) Copyright Jeff Rollason, PocketWare (TM) 1990-1994
  9.               All Rights Reserved
  10.  
  11.  
  12.  Contents:
  13.  
  14.     (1) PocketD Plus and Shareware
  15.         ASP
  16.         Shareware
  17.         PocketD Plus
  18.         Trademarks
  19.  
  20.     (2) Special Tips and Speeding up PocketD
  21.  
  22.     (3) Design Compromises
  23.  
  24.     (4) Compatibility and Limitations
  25.  
  26.  
  27.  (1) >>>>> PocketD Plus and Shareware
  28.  
  29.  PocketD Plus is a shareware product. You may use the software for free
  30.  for  30  days.  If you  continue  to use it after this time  you  must
  31.  register it through PocketWare (See below).
  32.  
  33.              _______
  34.             ____|__     |               (R)
  35.          --|       |    |-------------------
  36.            |   ____|__  |  Association of
  37.            |  |       |_|  Shareware
  38.            |__|   o   |    Professionals
  39.          -----|   |   |---------------------
  40.               |___|___|    MEMBER
  41.  
  42.  
  43.  Jeff   Rollason   is  a  member  of  the  Association   of   Shareware
  44.  Professionals  (ASP).  ASP  wants  to  make sure  that  the  shareware
  45.  principle   works   for  you.  If  you  are  unable   to   resolve   a
  46.  shareware-related  problem with an ASP member by contacting the member
  47.  directly,  ASP  may be able to  help. The ASP Ombudsman can  help  you
  48.  resolve  a dispute or problem with an ASP member, but does not provide
  49.  technical  support  for  members'  products. Please write to  the  ASP
  50.  Ombudsman  at  545  Grover  Road,  Muskegon, MI  USA  49442-9427,  FAX
  51.  616-788-2765,  or send a CompuServe message via CompuServe Mail to ASP
  52.  Ombudsman 70007,3536.
  53.  
  54.              ****************************
  55.              *  The Shareware Principle *
  56.              ****************************
  57.  
  58.  Software  distrubuted  as Shareware allows  the user to try out  fully
  59.  working programs before buying.
  60.  
  61.  >>>>> THIS IS THE IDEAL WAY TO BUY SOFTWARE:
  62.  
  63.     It  has the benefit of giving users the chance to fully try out
  64.     whether a product is suitable for their needs without risking a
  65.     wasted  financial  outlay. The  software is also CHEAPER!  (See
  66.     below).
  67.  
  68.  >>>>> THIS IS THE IDEAL WAY TO SELL SOFTWARE:
  69.  
  70.     The  Shareware  Author  does  not  have the  overhead  of  high
  71.     advertising   or   distribution  costs,  as  the   product   is
  72.     self-promoting.  In consequence Shareware products can be  sold
  73.     at a lower price than conventional retailed software.
  74.  
  75.  >>>>> IS SHAREWARE SOFTWARE ANY GOOD?
  76.  
  77.     Yes!  The  proof  of  this  is  obvious.  Shareware  completely
  78.     dominates  many areas of software, such as file compression and
  79.     communications, where Shareware clearly lead the markets.
  80.  
  81.  >>>>> IS IT FREE?
  82.  
  83.     No!  Much  time and effort  is required to turn  programs  into
  84.     polished and documented products. So if you seriously intend to
  85.     use a Shareware product, then support it!
  86.  
  87.  
  88.          ************************************
  89.          * The Shareware version of PocketD *
  90.          ************************************
  91.  
  92.  The  Shareware  version of  D.EXE has a built-in  Registration  banner
  93.  screen  that will appear whenever  the user accesses the full  on-line
  94.  manual,  also prompting the user to input a single digit between 1 and
  95.  4  to acknowledge the banner.  The same banner appears randomly 3%  of
  96.  the  time  whenever  D.EXE  is  run,  waiting  for any  key  input  or
  97.  continuing  anyway after 60  seconds (It can therefore run  unattended
  98.  during evaluation). MENUD.EXE has a similar mechanism.
  99.  
  100.  Users  must  refer  to  the  file VENDINFO.DIZ for the  DISCLAIMER  OF
  101.  WARRANTY and distribution restrictions.
  102.  
  103.                   TRADEMARKS
  104.  
  105.  All  trademarks  are acknowledged.  This and other  related  documents
  106.  refer to the following names, among others:
  107.  
  108. - OS/2 & PC-DOS are trademarks of International Business Machines Corp.
  109.   (IBM Inc.)
  110. - LIST  copyrighted by Vernon D. Buerg
  111. - Microsoft, Windows & MSDOS registered trademarks of the Microsoft Corp.
  112. - DIET  Written by Teddy Matsumoto
  113. - PKlite, PKzip, PKARC and PKPAK  trademarks of PKWARE Inc.
  114. - LZEXE copyrighted by Fabrice Bellard
  115. - ANARKEY copyrighted by Steve Calwas of Moderne Software
  116. - CED   Written by Christopher J. Dunford
  117. - NORTON trademark of Peter Norton
  118. - PCTOOLS copyrighted by Central Point Software, Inc.
  119. - LHA & LHARC copyrighted by H. Yoshizaki
  120. - ZOO   copyrighted program
  121. - ARC & SEA  copyrighted by SEA
  122. - ARJ   copyrighted by Robert K. Jung
  123. - DESQview copyrighted by Quarterdeck
  124. - 4DOS  copyrighted by J.P. Software
  125. - Novell NetWare copyright Novell
  126. - CompuServe registered trademark of CompuServe Inc.
  127.  
  128.  
  129.  (2) >>>>> Special tips and Speeding up PocketD
  130.  
  131.     PocketD  is intended for use from the command line. The user is
  132.     strongly  recommended  to use it  with one of the many  command
  133.     history  editors  such as CED  or ANARKEY. This will allow  the
  134.     user  to experiment with long command lines without needing  to
  135.     re-type command input.
  136.  
  137.     DOS  constrains the user to  inputing lines no longer than  128
  138.     characters  long.  This  is  a  serious constraint  when  using
  139.     multi-line  or  multiple  templates  or very large  numbers  of
  140.     filespecs.  A  way around  this  constraint is to make  use  of
  141.     user-defined parameters to build long lines. e.g.
  142.  
  143.         set a1=[echo Creating $n//md $n//pkunzip $w $n\]
  144.         set a2=[?Unpack ZIP file to its own subdir ?]
  145.  
  146.     which  could be used by  the following line to generate a  long
  147.     command  line that could not have been entered within a  single
  148.     line.
  149.         d programs.zip game*.zip util*.zip /- *temp  /a1 /a2
  150.  
  151.     Another solution to processing large numbers of files is to use
  152.     a "response" file, e.g.
  153.  
  154.         d <list [pkzip -m backup $w]R
  155.  
  156.     where  "list"  is a file  of any size containing the  filenames
  157.     (and paths) to be processed.
  158.  
  159.     Since  PocketD  (D.EXE)  can  be  slow  to  load and  run,  it
  160.     is  recommended   that  it  is   run  from  a ram disk   (e.g.
  161.     VDISK   or RAMDRIVE).  To further improve the  load speed,  the
  162.     user can  also aliase D to D:D (where D: is the ram drive).
  163.  
  164.     OS/2 Users! --> Look at the compatibility notes.
  165.  
  166.  
  167.  (3) >>>>> Design Compromises
  168.  
  169.     PocketD could have been designed differently.
  170.  
  171.     Many of its features could be expanded and made more exotic and
  172.     powerful.  For  example the  file viewer could  allow  wildcard
  173.     searches. D.EXE could make use of expanded memory and shell out
  174.     to  extended memory or  disk when running other programs.  File
  175.     copying could be made faster by buffering multiple files before
  176.     beginning a copy.
  177.  
  178.     All these are possible, but if implemented, the tiny 30k of the
  179.     (registered)  D.EXE program would be substantially bigger,  and
  180.     less attractive to those who need D.EXE to be very small.
  181.  
  182.     D.EXE  has  been carefully  designed to provide an  astonishing
  183.     range  of features within a truly tiny program. This has  meant
  184.     that  its  facilities  have  had  to be closely  integrated  to
  185.     achieve  the maximum utility for each code section added.  This
  186.     design  approach  has  been  very successful. D.EXE  cannot  be
  187.     completely  replaced  by any  other combination of  tool  sets,
  188.     despite  its small size. The program that does come closest  to
  189.     D.EXE in functionality has less than half the range of options,
  190.     but is over twice the size.
  191.  
  192.     One  particular  compromise  is  the  design of  the  directory
  193.     browser.  This traverses  subdirectories by re-invoking  D.EXE.
  194.     This  has the effect of limiting how deep the user can  browse,
  195.     only  about  9 levels on a  normal machine (or 8 if  called  by
  196.     MENUD).  It also imposes  limits on the screen refresh  between
  197.     levels  and the speed of traversing levels. The payoff has been
  198.     the   very  small  code  size  increase  to  D.EXE,  also   the
  199.     compensation  by  the  useful  and unique ability of  D.EXE  to
  200.     search  for and collect any group of files and directories from
  201.     multiple drives to be browsed within a single list.
  202.  
  203.     The  final compromise is the single letter option names, giving
  204.     parameter  strings  that are  often  hard to read. This  was  a
  205.     deliberate  decision to allow the user to combine large n